Constants


Action State Constants The NavActionState enumeration defines constants you can specify in the parms parameter of the function NavCustomControl in order to block certain actions in Navigation Services dialog boxes. When you specify these constants, you must also specify the kNavSetActionState constant in the selector parameter of the NavCustomControl function. For more information, see “Controlling User Navigation”. (These constants are only available in Navigation Services 2.0 or later.)
Custom Control Setting Constants The NavCustomControlMessage data type defines constants that your application can pass in the selector parameter of the function NavCustomControl to control various aspects of the active dialog box.
Dialog Option Configuration Constants In the dialogOptionFlags field of a structure of type NavDialogOptions, you can specify values for Navigation Services dialog box configuration options. Use the constants defined by the NavDialogOptionFlags data type to specify these values.
Discard Changes Action Constants After you call the function NavAskDiscardChanges, your application determines the result of the function call by checking the eventData field of a structure of type NavCBRec for one of the constants defined by the NavAskDiscardChangesResult data type.
Event Message Constants Your application can provide an event-handling function to update application windows and handle other events related to your Open and Save dialog boxes. Navigation Services informs you of pertinent events by supplying event message constants to your event-handling function via the param field of a structure of type NavCBRec. These constants are defined in the NavEventCallbackMessages data type. For more information, see “Handling Events”.
File Sorting Constants Your application can determine the sort key for displayed files by passing the kNavCtlSortBy constant, described in “Custom Control Setting Constants”, in the selector parameter of the function NavCustomControl, and passing one of the constants defined in the NavSortKeyField data type in the parms parameter of the NavCustomControl function.
Generic File Signature Constant To specify that your application can open all files of a given type (such as 'TEXT', for example), specify the kNavGenericSignature constant in the componentSignature field of the structure of type NavTypeList that you pass to a file-opening function such as NavGetFile. You can also pass this constant in the fileCreator parameter of the function NavPutFile in order to override the types of files appearing in the Format pop-up menu. For more information on using NavTypeList structures, see “Providing File Opening Options”. This constant is only available in Navigation Services 2.0 or later.
kNavDefaultNavDlogOptions
kNavDialogOptionsVersion
kNavMissingKindStringErr
Menu Item Selection Constants To set the default selection for the Show pop-up menu of an Open dialog box, your application passes the kNavCtlSelectAllType constant, described in “Custom Control Setting Constants”, in the selector parameter of the function NavCustomControl and passes one of the constants defined in the NavPopupMenuItem data type in the parms parameter of the NavCustomControl function.
NavActionState
NavAskDiscardChangesResult
NavAskSaveChangesAction
NavAskSaveChangesResult
NavCustomControlMessage
NavFilterModes
NavPopupMenuItem
NavSortKeyField
NavSortOrder
NavTranslationOptions
Object Filtering Constants Navigation Services passes one of the constants defined by the NavFilterModes data type to the filterMode parameter of your application-defined filter function to tell your application whether the browser list or one of the navigation option pop-up menus contains the object currently being filtered. For more information, see “Filtering File Objects”.
Save Changes Action Constants When you call the function NavAskSaveChanges, your application specifies a structure of type NavReplyRecord in the reply parameter. On completion, this structure contains a value represented by one of the constants defined by the NavAskSaveChangesResult data type.
Save Changes Request Constants Your application requests a Save Changes alert box by specifying one of the following constants, defined by the NavAskSaveChangesAction data type, in the action parameter of the function NavAskSaveChanges.
Sort Order Constants Your application can specify the sort order for displayed files by passing the kNavCtlSortOrder constant in the selector parameter of the function NavCustomControl and passing one of the constants defined in the NavSortOrder data type in the parms parameter of the NavCustomControl function.
Translation Option Constants Your application passes one of the NavTranslationOptions constants to the howToTranslate parameter to specify how files are to be translated by the function NavTranslateFile.
uppNavEventProcInfo
uppNavObjectFilterProcInfo
uppNavPreviewProcInfo

© 2000 Apple Computer, Inc. — (Last Updated 4/17/2000)